home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 2001 May / SGI IRIX Base Documentation 2001 May.iso / usr / share / catman / g_man / cat3 / OpenGL / glcopytexsubimage3d.z / glcopytexsubimage3d
Encoding:
Text File  |  2001-04-17  |  11.8 KB  |  200 lines
  1.  
  2.  
  3.  
  4. ggggllllCCCCooooppppyyyyTTTTeeeexxxxSSSSuuuubbbbIIIImmmmaaaaggggeeee3333DDDD((((3333GGGG))))        OOOOppppeeeennnnGGGGLLLL RRRReeeeffffeeeerrrreeeennnncccceeee        ggggllllCCCCooooppppyyyyTTTTeeeexxxxSSSSuuuubbbbIIIImmmmaaaaggggeeee3333DDDD((((3333GGGG))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      ggggllllCCCCooooppppyyyyTTTTeeeexxxxSSSSuuuubbbbIIIImmmmaaaaggggeeee3333DDDD - copy a three-dimensional texture subimage
  10.  
  11.  
  12. CCCC SSSSPPPPEEEECCCCIIIIFFFFIIIICCCCAAAATTTTIIIIOOOONNNN
  13.      void ggggllllCCCCooooppppyyyyTTTTeeeexxxxSSSSuuuubbbbIIIImmmmaaaaggggeeee3333DDDD( GLenum _t_a_r_g_e_t,
  14.                                GLint _l_e_v_e_l,
  15.                                GLint _x_o_f_f_s_e_t,
  16.                                GLint _y_o_f_f_s_e_t,
  17.                                GLint _z_o_f_f_s_e_t,
  18.                                GLint _x,
  19.                                GLint _y,
  20.                                GLsizei _w_i_d_t_h,
  21.                                GLsizei _h_e_i_g_h_t )
  22.  
  23.  
  24. PPPPAAAARRRRAAAAMMMMEEEETTTTEEEERRRRSSSS
  25.      _t_a_r_g_e_t   Specifies the target texture.  Must be GGGGLLLL____TTTTEEEEXXXXTTTTUUUURRRREEEE____3333DDDD
  26.  
  27.      _l_e_v_e_l    Specifies the level-of-detail number.  Level 0 is the base image
  28.               level.  Level _n is the _nth mipmap reduction image.
  29.  
  30.      _x_o_f_f_s_e_t  Specifies a texel offset in the x direction within the texture
  31.               array.
  32.  
  33.      _y_o_f_f_s_e_t  Specifies a texel offset in the y direction within the texture
  34.               array.
  35.  
  36.      _z_o_f_f_s_e_t  Specifies a texel offset in the z direction within the texture
  37.               array.
  38.  
  39.      _x, _y     Specify the window coordinates of the lower left corner of the
  40.               rectangular region of pixels to be copied.
  41.  
  42.      _w_i_d_t_h    Specifies the width of the texture subimage.
  43.  
  44.      _h_e_i_g_h_t   Specifies the height of the texture subimage.
  45.  
  46. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  47.      ggggllllCCCCooooppppyyyyTTTTeeeexxxxSSSSuuuubbbbIIIImmmmaaaaggggeeee3333DDDD replaces a rectangular portion of a three-dimensional
  48.      texture image with pixels from the current GGGGLLLL____RRRREEEEAAAADDDD____BBBBUUUUFFFFFFFFEEEERRRR (rather than
  49.      from main memory, as is the case for ggggllllTTTTeeeexxxxSSSSuuuubbbbIIIImmmmaaaaggggeeee3333DDDD).
  50.  
  51.      The screen-aligned pixel rectangle with lower left corner at (_x, _y) and
  52.      with width _w_i_d_t_h and height _h_e_i_g_h_t replaces the portion of the texture
  53.      array with x indices _x_o_f_f_s_e_t through _x_o_f_f_s_e_t + _w_i_d_t_h - 1, inclusive, and
  54.      y indices _y_o_f_f_s_e_t through _y_o_f_f_s_e_t + _h_e_i_g_h_t - 1, inclusive, at z index
  55.      _z_o_f_f_s_e_t and at the mipmap level specified by _l_e_v_e_l.
  56.  
  57.      The pixels in the rectangle are processed exactly as if ggggllllCCCCooooppppyyyyPPPPiiiixxxxeeeellllssss had
  58.      been called, but the process stops just before final conversion.  At this
  59.      point, all pixel component values are clamped to the range [0, 1] and
  60.  
  61.  
  62.  
  63.                                                                         PPPPaaaaggggeeee 1111
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70. ggggllllCCCCooooppppyyyyTTTTeeeexxxxSSSSuuuubbbbIIIImmmmaaaaggggeeee3333DDDD((((3333GGGG))))        OOOOppppeeeennnnGGGGLLLL RRRReeeeffffeeeerrrreeeennnncccceeee        ggggllllCCCCooooppppyyyyTTTTeeeexxxxSSSSuuuubbbbIIIImmmmaaaaggggeeee3333DDDD((((3333GGGG))))
  71.  
  72.  
  73.  
  74.      then converted to the texture's internal format for storage in the texel
  75.      array.
  76.  
  77.      The destination rectangle in the texture array may not include any texels
  78.      outside the texture array as it was originally specified.  It is not an
  79.      error to specify a subtexture with zero width or height, but such a
  80.      specification has no effect.
  81.  
  82.      If any of the pixels within the specified rectangle of the current
  83.      GGGGLLLL____RRRREEEEAAAADDDD____BBBBUUUUFFFFFFFFEEEERRRR are outside the read window associated with the current
  84.      rendering context, then the values obtained for those pixels are
  85.      undefined.
  86.  
  87.      No change is made to the _i_n_t_e_r_n_a_l_f_o_r_m_a_t, _w_i_d_t_h, _h_e_i_g_h_t, _d_e_p_t_h, or _b_o_r_d_e_r
  88.      parameters of the specified texture array or to texel values outside the
  89.      specified subregion.
  90.  
  91. NNNNOOOOTTTTEEEESSSS
  92.      ggggllllCCCCooooppppyyyyTTTTeeeexxxxSSSSuuuubbbbIIIImmmmaaaaggggeeee3333DDDD is available only if the GL version is 1.2 or
  93.      greater.
  94.  
  95.      Texturing has no effect in color index mode.
  96.  
  97.      ggggllllPPPPiiiixxxxeeeellllSSSSttttoooorrrreeee and ggggllllPPPPiiiixxxxeeeellllTTTTrrrraaaannnnssssffffeeeerrrr modes affect texture images in exactly
  98.      the way they affect ggggllllDDDDrrrraaaawwwwPPPPiiiixxxxeeeellllssss.
  99.  
  100.      When the GGGGLLLL____AAAARRRRBBBB____iiiimmmmaaaaggggiiiinnnngggg extension is supported, the RGBA components
  101.      copied from the framebuffer may be processed by the imaging pipeline, as
  102.      if they were a two-dimensional texture.  See ggggllllTTTTeeeexxxxIIIImmmmaaaaggggeeee2222DDDD for specific
  103.      details.
  104.  
  105. EEEERRRRRRRROOOORRRRSSSS
  106.      GGGGLLLL____IIIINNNNVVVVAAAALLLLIIIIDDDD____EEEENNNNUUUUMMMM is generated if _t_a_r_g_e_t is not GGGGLLLL____TTTTEEEEXXXXTTTTUUUURRRREEEE____3333DDDD.
  107.  
  108.      GGGGLLLL____IIIINNNNVVVVAAAALLLLIIIIDDDD____OOOOPPPPEEEERRRRAAAATTTTIIIIOOOONNNN is generated if the texture array has not been
  109.      defined by a previous ggggllllTTTTeeeexxxxIIIImmmmaaaaggggeeee3333DDDD or ggggllllCCCCooooppppyyyyTTTTeeeexxxxIIIImmmmaaaaggggeeee3333DDDD operation.
  110.  
  111.      GGGGLLLL____IIIINNNNVVVVAAAALLLLIIIIDDDD____VVVVAAAALLLLUUUUEEEE is generated if _l_e_v_e_l is less than 0.
  112.  
  113.      GGGGLLLL____IIIINNNNVVVVAAAALLLLIIIIDDDD____VVVVAAAALLLLUUUUEEEE may be generated if _l_e_v_e_l is greater than log max, where
  114.                                                                    2
  115.      max is the returned value of GGGGLLLL____MMMMAAAAXXXX____3333DDDD____TTTTEEEEXXXXTTTTUUUURRRREEEE____SSSSIIIIZZZZEEEE.
  116.  
  117.      GGGGLLLL____IIIINNNNVVVVAAAALLLLIIIIDDDD____VVVVAAAALLLLUUUUEEEE is generated if _x <  -b or if _y <  -b, where b is the
  118.      border width of the texture array.
  119.  
  120.      GGGGLLLL____IIIINNNNVVVVAAAALLLLIIIIDDDD____VVVVAAAALLLLUUUUEEEE is generated if xoffset < -b,
  121.      (_x_o_f_f_s_e_t + _w_i_d_t_h) > (w - b), _y_o_f_f_s_e_t <  -b, (_y_o_f_f_s_e_t + _h_e_i_g_h_t) > (h - b),
  122.      _z_o_f_f_s_e_t <  -b, or _z_o_f_f_s_e_t > (d - b), where w is the GGGGLLLL____TTTTEEEEXXXXTTTTUUUURRRREEEE____WWWWIIIIDDDDTTTTHHHH, h
  123.      is the  GGGGLLLL____TTTTEEEEXXXXTTTTUUUURRRREEEE____HHHHEEEEIIIIGGGGHHHHTTTT, d is the GGGGLLLL____TTTTEEEEXXXXTTTTUUUURRRREEEE____DDDDEEEEPPPPTTTTHHHH, and b is the
  124.      GGGGLLLL____TTTTEEEEXXXXTTTTUUUURRRREEEE____BBBBOOOORRRRDDDDEEEERRRR of the texture image being modified.  Note that w, h,
  125.      and d include twice the border width.
  126.  
  127.  
  128.  
  129.  
  130.                                                                         PPPPaaaaggggeeee 2222
  131.  
  132.  
  133.  
  134.  
  135.  
  136.  
  137. ggggllllCCCCooooppppyyyyTTTTeeeexxxxSSSSuuuubbbbIIIImmmmaaaaggggeeee3333DDDD((((3333GGGG))))        OOOOppppeeeennnnGGGGLLLL RRRReeeeffffeeeerrrreeeennnncccceeee        ggggllllCCCCooooppppyyyyTTTTeeeexxxxSSSSuuuubbbbIIIImmmmaaaaggggeeee3333DDDD((((3333GGGG))))
  138.  
  139.  
  140.  
  141.      GGGGLLLL____IIIINNNNVVVVAAAALLLLIIIIDDDD____OOOOPPPPEEEERRRRAAAATTTTIIIIOOOONNNN is generated if ggggllllCCCCooooppppyyyyTTTTeeeexxxxSSSSuuuubbbbIIIImmmmaaaaggggeeee3333DDDD is executed
  142.      between the execution of ggggllllBBBBeeeeggggiiiinnnn and the corresponding execution of
  143.      ggggllllEEEEnnnndddd.
  144.  
  145. AAAASSSSSSSSOOOOCCCCIIIIAAAATTTTEEEEDDDD GGGGEEEETTTTSSSS
  146.      ggggllllGGGGeeeettttTTTTeeeexxxxIIIImmmmaaaaggggeeee
  147.      ggggllllIIIIssssEEEEnnnnaaaabbbblllleeeedddd with argument GGGGLLLL____TTTTEEEEXXXXTTTTUUUURRRREEEE____3333DDDD
  148.  
  149.  
  150. SSSSEEEEEEEE AAAALLLLSSSSOOOO
  151.      ggggllllCCCCooooppppyyyyPPPPiiiixxxxeeeellllssss, ggggllllCCCCooooppppyyyyTTTTeeeexxxxIIIImmmmaaaaggggeeee1111DDDD, ggggllllCCCCooooppppyyyyTTTTeeeexxxxIIIImmmmaaaaggggeeee2222DDDD, ggggllllCCCCooooppppyyyyTTTTeeeexxxxSSSSuuuubbbbIIIImmmmaaaaggggeeee1111DDDD,
  152.      ggggllllCCCCooooppppyyyyTTTTeeeexxxxSSSSuuuubbbbIIIImmmmaaaaggggeeee2222DDDD, ggggllllPPPPiiiixxxxeeeellllSSSSttttoooorrrreeee, ggggllllPPPPiiiixxxxeeeellllTTTTrrrraaaannnnssssffffeeeerrrr, ggggllllRRRReeeeaaaaddddBBBBuuuuffffffffeeeerrrr,
  153.      ggggllllTTTTeeeexxxxEEEEnnnnvvvv, ggggllllTTTTeeeexxxxGGGGeeeennnn, ggggllllTTTTeeeexxxxIIIImmmmaaaaggggeeee1111DDDD, ggggllllTTTTeeeexxxxIIIImmmmaaaaggggeeee2222DDDD, ggggllllTTTTeeeexxxxIIIImmmmaaaaggggeeee3333DDDD,
  154.      ggggllllTTTTeeeexxxxPPPPaaaarrrraaaammmmeeeetttteeeerrrr, ggggllllTTTTeeeexxxxSSSSuuuubbbbIIIImmmmaaaaggggeeee1111DDDD, ggggllllTTTTeeeexxxxSSSSuuuubbbbIIIImmmmaaaaggggeeee2222DDDD, ggggllllTTTTeeeexxxxSSSSuuuubbbbIIIImmmmaaaaggggeeee3333DDDD
  155.  
  156.  
  157.  
  158.  
  159.  
  160.  
  161.  
  162.  
  163.  
  164.  
  165.  
  166.  
  167.  
  168.  
  169.  
  170.  
  171.  
  172.  
  173.  
  174.  
  175.  
  176.  
  177.  
  178.  
  179.  
  180.  
  181.  
  182.  
  183.  
  184.  
  185.  
  186.  
  187.  
  188.  
  189.  
  190.  
  191.  
  192.  
  193.  
  194.  
  195.  
  196.                                                                         PPPPaaaaggggeeee 3333
  197.  
  198.  
  199.  
  200.